home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / cpp_libs / copytape.lha / copytape / copytape.1.man < prev    next >
Text File  |  1990-01-09  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.                                                       COPYTAPE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      copytape - duplicate magtapes
  10.  
  11. SYNOPSIS
  12.      copytape [-f] [-t] [-s_n_n_n] [-l_n_n_n] [-v] [_i_n_p_u_t [_o_u_t_p_u_t]]
  13.  
  14. DESCRIPTION
  15.      _c_o_p_y_t_a_p_e duplicates magtapes.  It is intended for duplica-
  16.      tion of bootable or other non-file-structured (non-tar-
  17.      structured) magtapes on systems with only one tape drive.
  18.      _c_o_p_y_t_a_p_e is blissfully ignorant of tape formats.  It merely
  19.      makes a bit-for-bit copy of its input.
  20.  
  21.      In normal use, _c_o_p_y_t_a_p_e would be run twice.  First, a boot
  22.      tape is copied to an intermediate disk file.  The file is in
  23.      a special format that preserves the record boundaries and
  24.      tape marks.  On the second run, _c_o_p_y_t_a_p_e reads this file and
  25.      generates a new tape.  The second step may be repeated if
  26.      multiple copies are required.  The typical process would
  27.      look like this:
  28.  
  29.           tutorial% copytape /dev/rmt8 tape.tmp
  30.           tutorial% copytape tape.tmp /dev/rmt8
  31.           tutorial% rm tape.tmp
  32.  
  33.      _c_o_p_y_t_a_p_e copies from the standard input to the standard out-
  34.      put, unless input and output arguments are provided.  It
  35.      will automatically determine whether its input and output
  36.      are physical tapes, or data files.  Data files are encoded
  37.      in a special (human-readable) format.
  38.  
  39.      Since _c_o_p_y_t_a_p_e will automatically determine what sort of
  40.      thing its input and output are, a twin-drive system can
  41.      duplicate a tape in one pass.  The command would be
  42.           tutorial% copytape /dev/rmt8 /dev/rmt9
  43.  
  44. OPTIONS
  45.      -s_n_n_n
  46.         Skip tape marks.  The specified number of tape marks are
  47.         skipped on the input tape, before the copy begins.  By
  48.         default, nothing is skipped, resulting in a copy of the
  49.         complete input tape.  Multiple tar(1) and dump(1)
  50.         archives on a single tape are normally separated by a
  51.         single tape mark.  On ANSI or IBM labelled tapes, each
  52.         file has three associated tape marks.  Count carefully.
  53.  
  54.      -l_n_n_n
  55.         Limit.  Only nnn files (data followed by a tape mark), at
  56.         most, are copied.  This can be used to terminate a copy
  57.         early.  If the skip option is also specified, the files
  58.         skipped do not count against the limit.
  59.  
  60.  
  61.  
  62.  
  63.                                                                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. COPYTAPE(1)
  71.  
  72.  
  73.  
  74.      -f From tape.  The input is treated as though it were a phy-
  75.         sical tape, even if it is a data file.  This option can
  76.         be used to copy block-structured device files other than
  77.         magtapes.
  78.  
  79.      -t To tape.  The output is treated as though it were a phy-
  80.         sical tape, even if it is a data file.  Normally, data
  81.         files mark physical tape blocks with a (human-readable)
  82.         header describing the block.  If the -t option is used
  83.         when the output is actually a disk file, these headers
  84.         will not be written.  This will extract all the informa-
  85.         tion from the tape, but _c_o_p_y_t_a_p_e will not be able to
  86.         duplicate the original tape based on the resulting data
  87.         file.
  88.  
  89.      -v Verbose.  _c_o_p_y_t_a_p_e does not normally produce any output
  90.         on the control terminal.  The verbose option will iden-
  91.         tify the input and output files, tell whether they are
  92.         physical tapes or data files, and announce the size of
  93.         each block copied.  This can produce a lot of output on
  94.         even relatively short tapes.  It is intended mostly for
  95.         diagnostic work.
  96.  
  97. FILES
  98.      /dev/rmt*
  99.  
  100. SEE ALSO
  101.      ansitape(1), dd(1), tar(1), mtio(4), copytape(5)
  102.  
  103. AUTHOR
  104.      David S. Hayes, Site Manager, US Army Artificial Intelli-
  105.      gence Center.  Originally developed September 1984 at
  106.      Rensselaer Polytechnic Institute, Troy, New York.  Revised
  107.      July 1986.  This software is in the public domain.
  108.  
  109. BUGS
  110.      _c_o_p_y_t_a_p_e treats two successive file marks as logical end-
  111.      of-tape.
  112.  
  113.      The intermediate data file can consume huge amounts of disk
  114.      space.  A 2400-foot reel at 6250-bpi can burn 140 megabytes.
  115.      This is not strictly speaking a bug, but users should be
  116.      aware of the possibility.  Check disk space with _d_f(_1)
  117.      before starting _c_o_p_y_t_a_p_e.  Caveat Emptor!
  118.  
  119.      A 256K buffer is used internally.  This limits the maximum
  120.      block size of the input tape.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. 2
  130.  
  131.  
  132.  
  133.